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A system is described which provides an interactive graphical 
debugging facility for user programs. This system is implemented 
on an Adage AGT-10 and is operational for online debugging of higher- 
level language programs executing on an XDS 9300 host computer. 
System avempecture and implementation are discussed. “Aiormial 
definition of the DEBUG Command Language is given and a description 


of the utilization of the commands for program debugging is presented. 
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Il. INTRODUC Teh 


Frequently one of the most time and money consuming efforts in 
the development of computer programs and their revisions is that 
devoted to debugging. In the present context debugging refers to the 
detection, location and elimination of program bugs which may have 
Originated as errors in program logic or clerical mistakes such as in 
keypunching. Typically, with a batch processing computer configura- 
tion, the debugging effort will involve repeated computer runs, hand 
simulation of portions of the program, and not infrequently, the inser- 
fot Of numerous WRITE or PRINT statements solely to provide an 
indication of nrogram flow and/or vajues attained bv program variables 
in the course of execution. When the bugs have been eliminated these 


additional statements are removed to provide the finished program. 


A. DEBUGGING SYSTEMS 

The programmer might be greatly aided in reducing the necessary 
effort of program checkout if a powerful debugging system were avail- 
able to assist him. Such a system should enable a user to observe 
pertinent aspects of the execution of his program without requiring 
modifications to it. Most manufacturers of computer systems provide 
at least a rudimentary debugging package with their operating systems. 
Unfortunately, some of these are so complex in their operation as to 


preclude all but the most expcrienced programmers from usi... t cm 








Nearly all such packages require that the user prepare for debugging 
prior to compilation and execution of his program. §Oftea aus peceial 
compilation mode is necessary and changes in debugging requests 
cannot be made without reloading and reexecution of the program. 
Basically, deébupping systems may be divided intomcapevorics 
depending upon when they interact with the user's program, i.e. 
@emapile-time, load-time or execution-time debugping. Aithouegn there 
pee CCTtaln advantages to the first two of these methods, they neces- 
sitate a fairly complicated debugging package that is essentially built 
iaro the operating system, and is restricted to handling only programs 
fuer a particular set of language processors. It is the intent of this 
pawer to be concerned solely with execution-time debugging, which is 


readily adaptable to the system under consideration. 


Pee AE CUTION-TIME DEBUGGING 

Mxecution-time debugging may be language independent to a greater 
eferee than the other two types mentioned above, and may be more 
readily adapted to a computer without extensive modifications to the 
Operating system. However, in some implementations it often requires 
that the user be highly versed as a machine language programmer, or 
mretact as a machine operator, to ee WS emet tS) tea tiiesmroOon Trhequent 
occasions a user who is well acquainted with the internal operation ofa 


particular computer may choose to debug portions of a program by 


sitting at the computer console and single-stepping through portions ot 


8 








his program, displaying contents of repisters, e€tco A itmou meee oem, 
be applicable in many situations, in practice it is evident that computer 
control consoles are not well adapted to debugging. Some means of 
providing a console facility more suitable to debugging might be 
desirable. 

It has been mentioned that one of the drawbacks of execution-time 
debugging is that the user might need to be competent as a machine 
language programmer. This stems from the need to understand the 
eaenificance of the contents of registers displayed in binary, octal, 
etc. and the lack of most information relating to such things as higher 
level language variable names at execution time. It will be shown here 
' how the use of a small peripheral processor can reconstruct sufficient 


information to be of value to the user of a higher ievel ianguage. 


C. OFFLINE VERSUS ONLINE DEBUGGING 

A further subdivision of most forms of debugging may be made, 
mamely into online and offline systems. The distinction between the 
two is whether or not the user is able to interact with his program for 
debugging purposes eine ENG cOUdTSe.Of lis eseculiom rl 1s Olcr Migs: 
desirable for the user to be able to debug his programs online, as from 
Maesauthor's experience the very nature of program debugging often 
mamkes it difficult to predict the areas of a program in which errors 
wi occur. The debugging process is in reality an interaction between 


the user and his program, and the opportunity for the user to devug 
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online heightens this interaction. Additionally, the taeriit, toe orc. 
temporary patches and fixes during execution as the errors are 


detected may prevent many nearly duplicate ororramenuns. 
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Il. AN INTERACTIVE GRAPEICAL DEBEU CGiNG S454 277 


The system described here is an attempt to provide an online, 
execution-time debugging system in an environment where sucha 
package was not formerly available. It includes the functions of an 
extended computer operating console specifically adapted for debugping 
with features that are useful to the FORTRAN user. Although an under = 
standing of machine language is not necessary for use of all features, 
Mmeis advantageous for the most complete utilization of DEBUG. 

This debugging system (DEBUG) has been developed for use with 
the Xerox Data Systems 9300/Adage Graphics Terminal-10 system in 
meee lectricel Engineering Devartment Hybrid Computer Leborate: 
at the Naval Postgraduate School. This machine configuration consists 
of one XDS 9300 central processing unit with input/output equipment 
and a high speed Pe eeniont data channel attached to tvo AG? 210 
graphics terminals. Inthe normal mode of operation on the configura- 
tion a FORTRAN program onthe XDS 9300 utilizes one of the AGT-10 
terminals as a slave device for interactive graphical processing. 
Mechine utilization includes faculty and student research, thesis 
projects and laboratory exercises, necessitating a considerable and 
continuing effort in individual program debugging. 

DEBUG operates on either of the AGT-10 graphics terminals and 


is used to debug programs on the XDS 9300 which may be usin=s the 


)] 








other AGT-10 as a slave graphics device. The nature of the graphics 
iiveriace between tic XDS 9300 and the AGT-10 is such that the majority 
of information desired by the programmer is available in 9300 core 
memory. No alterations to the existing XDS 9300 Real Time Monitor 
were necessary. Three levels of interaction with the user program are 
available, their use being dependent upon the user's competence in 
machine language programming, ite nature of the errors he is attempt— 
ing to locate and the possible desire to avoid modification of the source 


program. 


pee NON -INTERFERENCE LEVEL 

At this level of interaction, the debugging system acts solely as an 
Observer, providing dynamic core dumps, displaying valves in locations, 
m@eenterpreting such values. No modifications are made to the execu- 


monmeot the running program. 


PENT ERACTIVE LEVEL 

For most debugging operations, the user wishes to interact with 
his program, and may do so in DEBUG by Pcontiws breakpoint traps, 
'babysitting' on a location for a change in value, altering program code 
G@umeata contents, or decreasing the execution speed of the program. 
This mode does not modify the user source program itself, but may 
alter the contents of the execution-time core memory image of the 


freepram at the specific request of theuser: 
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CG. AUTOMATIC SYMBOL LEVEL 

If the programmer is willing to allow a reallocation of his program 
in 9300 core memory, the possibility of using a significantly greater 
amount of storage, and knows prior to compilation that he wishes to use 
the debugging package, he may utilize several additional debugging aids. 
Sime most convenient of these is to have all the symbols, suchas FORTRAN 
variable names, predefined and automatically available to the user at 
execution time through DEBUG. This feature requires that the user 
include a ‘blanket’ NAMELIST statement in his FORTRAN program. 

DEBUG uses the graphical display subsystem of the AGT-10, with 
a fourteen inch display area, for presenting all information requested 
by user debugging commands. Depending upon the type of commands 
issued by the user and the screen area currently occupied the debugging 
data may be accumulated on the display screen or will replace currently 
displayed information. Most displays are dynamic and are updated 
continually as the 9300 program execution progresses. Command 
wapu irom the user is typed on the keyboard of a model 33 teletype- 
feeteer, with an image of the current input buffer displayed on the 
Semeen. Due to the utilization of a separate processor for debugging, 
mmethe ability to directly access XDS 9300 core memory, DEBUG 
makes no demands on the resources of the attached XDS 9300 computer, 
other than core memory access conflicts allowing program execution 
to proceed essentially unaffected except when specifically interrupted 


py the user. 
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lll. SYSTEM ORGANIZATION 


The Interactive Graphical Debugging System consists of a single 
program package for the AGT-.10. This package is coded entirely in 
the Adage Extendable Program Translator (ADEPT) assembler language 
emaceconsists of approximately 1800 statements. Once initiated, the 
program package operates without the assistance of any external sub- 
routines or monitor functions. Although DEBUG does not communicate 
with the AGT monitor system, AMRMX, they are entirely compatible 
and DEBUG provides the facility to rapidly return control to the monitor 
under operator command. The DEBUG program package includes a 
main commutator, command nrocessing routines, and an input-outpvut 


section, 


A. MAIN COMMUTATOR 

The main commutator is the heart of the program package. It 
consists of a loop witha series of gates to various program segments. 
After initialization, the program loops continually through the veom= 
hambaror, with the exception of interrupts generated by the input-output 
hardware. Each gate in the commutator is a branchpoint to an individ- 
ual program section, and each gate may be either open or shut at any 
Particular time as needed to control the processing of operator requests. 
Most interrupts from input-output servicing cause a gate in the com- 


‘ 
om, 2 


mutator to be opened, thus allowing the actual processing done a 
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interrupt time to be minimal. This technique also ensures that program 
code that cannot logically be executed out of sequence will not be im- 


inoperly initiated by an interrupt. 


B. COMMAND PROCESSING 

When the input-output routines determine that the user has completed 
typing a request, which must end with the carriage return character, a 
gate in the commutator is opened to the command decoding program 
segment. This program segment scans the input text line, breaks it 
into individual arguments as delimiters are encountered and stores the 
mepmmachnts. kach-argument is in turn examined, determined to be one 
of several types and properly decoded to a common format. At this 
point, all BCD arguments are checked for a match in the symbol table, 
and if found the equivalent value is substituted for the symbol. Simple 
arithmetic addition er selietion of subfields within arguments is 
permitted, thus allowing the user to refer to such things as locations 
relative to a known symbol. 

After all arguments have been processed, the command itself is 
looked up ina table a predefined commands and the appropriate pro- 
gram segment is executed. If the task to be performed is short or of 
emonme-time nature it is executed immediately, otherwise a gate to 
perform it is set in the main commutator. After the task is performed 
or the gate set, the command processor regains control, closes its 


own gate and returns to the commutator. From this point for. ard, al! 


lies. 








user initiated commands of a continuous néture will be performed by 
individual program segments tailored to the specific function. 

The command processor includes various error messages for 
improper arguments and invalid commands, which reply to the operator 
Wia the teletypewriter printer and terminate processing of the current 


user command. 


ee iNPUT.OUTPUT 

The input-output program segment consists of a set of subroutines 
Bomprocess interrupts from the input-output hardware, and to initiate 
mequests for input or output. Included in this segment are routines for 
assembling or disassembling characters bitwise for the serial tele- 
meeewriter interface, transfering information to or from the XDS 9300 
core memory, and driving the AGT graphics display subsystem. Sub- 
Poutines for character set conversion, numeric value conversion and 
error message gencration are also located in this segment. 

Due to the nature of the debugging process, in which the user may 
make frequent requests of the system, the teletypewriter input sub- 
routines provide facilities for ease of operation and correcting mistakes 
berore the requests are executed by sDEREBUG Backspace and line erase 
functions are provided by designated keys onthe keyboard. The current 
content of the input typing buffer is continuously displayed near the 
lower dee of the display screen, so that the operator may verify his 


Fe 


requests without looking away from the display. The interaction oi: t 


16 





command decoder with the input-output routines is such that the input 
text line is erased from the left as each argument is processed. Ifan 
error is detected by the command processor, the operator may readily 
determine the point at which it was detected by observing how much of 


the command has been erased when the error message occurs. 


ey 





ie DEBUGSCOMMAND LANGUAGE 


All processing and displays Heneneed by DEBUG are the direct 
mesuit Of USEr imtiated tequests in the DEBUG command lancuace. 
Requests in the command language are always inputted through the 
AGT.10 teletypewriter keyboard, and may be entered at any time 


according to the desires of the user. 


A. DEFINITIONS 
Some definitions which are necessary for understanding and 
itimeation of the command language are given here: 
i Symbolic Reference 
A symbolic reference is a word having up to eight alphameric 
characters, at least one of which is non-numeric. They ave used aor 
Pao purposes; 
a. Command Names 
A command name is a name used to identify a particular 
command. 
b. Symbol 
A symbol is a name which is equated to an arithmetic or 
character string constant. Such symbols may be used as command 
operands interchangeably with the constants they represent. Symbols 
are defined individually by bite use of the symbol definition command, 


or as a group in the automatic symbol definition mode. In th: yurer 
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case, the defined symbols are equated to the octal location value of 
corresponding program variable. 
ZnO latmiacenic 
A command is some specific instruction issued by the user 
which will cause a pre-defined sequence of operations to occur. Com- 
mands are of three classifications: 
a. Action Command 
An action command is a command which initiates some 
meiton desired by the user. These commands normally alter the display 
on the AGT-10 graphics unit, cause a given test condition to be enabled 
G@amaiter the course of execution of the program being debugged. Action 
commands consist of a command name possibly followed by an operand 
list, depending upon command type and user intent. 
b. Symbol Definition Command 
A symbol definition command is a command which equates 
a symbol to a specified value. These commands cause no changes in 
the display or program execution when they are executed.’ Symbol 
definition commands consist of the symbol to be defined, the equals 
Stemand a single operand prescribing the value to be attached to the 
symbol. 
c. Value Inquiry Command 
A value inquiry command is one which requests that the 
value of.an operand or symbol be displayed. These commands cause 


no changes in the display or program execution other than the req: vsted 








Value which is presented in the area of the input ty pimeeemtier displ, 
until the next command is typed. Value inquiry commands consist of 
a symbol or operand followed by the equals sign. 
3. Operand List 

Most commands require some modifying information. This 
information is supplied along with the command name in the operand 
list. .An operand list is a series of one to four operands, separated 
Peecomimas, with the entire list enclosed in left and right parentheses, 

4, Operands 

An operand is an element in an operand list, or may be the 
value to be equated in a symbol definition command. Operands may 
be any of the following forms: 

a. Character String Constant 

A character string constant is a series of up to eight 

alphameric characters, at least one of which must be non-numeric. 
It has the value of the octal equivalent of the BCD characters in the 
String, Embedded blanks are permissible, Character string constants 
of less than eight characters are filled with trailing blanks. 

b. Octal Constant 

An octal constant is an actual parameter consisting of up 

to eipht octal digits. Octal digits may be any character from the set 
irl, 2,3,4,5,6, 7). An octal constant with less than eight octal digits 


is internally filled with leading zeroes. 
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c. Decimal Constant 
A decimal constant is an actual parameter consisting of 
up to six decimal digits followed by a decimal point. The maximum 
value of a decimal constant is 163839. Decimal digits may be any 
eharacter from the set (0, 1,2,3,4,5,6,7,8,9). Decimal constants 
eLigte means: tilled with téading Zeroes. 
d. Floating Domecone ant 
A floating point constant is an actual parameter consisting 
of a decimal] constant followed by a decirnal fraction part, where the 
Giecinial fraction part consists of up to five decimal digits. 
C. Symbol 
A symbol used as an operand is replaced by the value 
which that symbol is defined to have. Note that symbois are of the 
same form as character string constants. Whenever an alpharinerical 
operand is encountered, it is used as a symbol if such a symbol has 
been defined, otherwise it is taken as a character string constant. 
i. spt ession 
| Bn expLession is anvasequence or subfields joined by ithe 
meebometic operators + Or -. Each subfield may be any type of operand 
Saeepcan expression. Lhe value of the expression is the result of 
performing the given arithmetic operations on the subfields from left 
to right. Two's complement arithmetic is used to maintain compatibility 
with the XDS 9300 internal eoystane entation of numbers. It is permissible 


fOr an expression to start with either an operator ora subfiel@ wae: it 
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must end with a subfield. Neither double operators nor double subfields 


ace per imrtod. 


B. COMMAND LANGUAGE FORMAT 


Action commands will be given in the following format: 


COMMAND OPERANDS 


operand ot , operand3 


WHERE 


operand! — 7 ,..cee.- 





The following notational conventions will be used: 
i; Small Letters 
einall letters in the command description represent values, 
names, etc. that must be replaced by meaningful coding by the user. 
mivese are further explained in the WHERE section. 
2. Capital Letters 
Capital letters in the command description are to be coded as 
shown. The same applies to the following special characters: ) ( = , 
See oedtare Brackets 
[ ] indicate that the contents are optional and need only be 
coded if the default is not to be taken. 
oe preces 
3 3 INGtGate a lus irom When exactly One thing musk ts 


selected. 








For example, in the format showijabove wee asSmthercormmiang 
name and would appear exactly as shown. Operand!l! is required and 
some appropriate coding must be supplied by the user. The rest of 
the operands are optional; however if the second is coded it must be 
codedas lor 2. If the second is omitted and the third is supplied the 
commas between them must be included. The left and right parentheses 
around the operand list must be coded as shown. The section labeled 
WHERE will give amplifying information concerning the types of 
meerands, etc. 

The individual commands are given in the Appendices with a 


detailed description of their format and usage. 
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V. SYSTEM COMMAND CAPABILITIES 


Three levels of user mnteraciion as DEBUG have been previously 
specified, and to each of these levels various commands are applicable. 
There is no need for the user to explicitly state which level of inter- 
metion he intends to use, rather the level is implhed by the user's 
requests and actions. A discussion of the command features available 
within each level follows. All commands at any level are also available 
for use within the levels above them. The details and format of each 


command appear in the appendices. 


A. NON-INTERFERENCE LEVEL 

In the non-interference mode of operation, it is possible to operate 
the DEBUG package without alerting the XDS 9300 that it is being used. 
In fact, this mode is well suited to attempting to diagnose a program 
failure after it occurs. The debugging system operates as an observer 
maceimiterpreter. The following commands are available: 

1, DUMP Command 

The DUMP command allows the user tO display the contents of 

eight to one hundred sixty locations in the XDS 9300 core memory on 
the AGT-10 display screen. The display format is that of the familiar 
octal and BCD memory dump, eight locations per line, with the addresses 
being dumped listed along ne left margin. The dump is dynamic and 


allows the user to view changes in the selected core section they Oa 
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2 ee U ME @emomand 
The UNDUMP command terminates operation of a previously 
initiated DUMP command. 
5.  HeieD Conamiamd 
The HOLD command allows the user to disable the dynamic 
feature of the current DUMP display, that is, the display will not be 
updated to reflect changes that may occur in the area of XDS 9300 
core memory being displayed. 
4, FREE Command 
This command is the inverse of the HOLD command, and 
causes dynamic updating of the DUMP display to recommence. 
aoe AGE Command 
The user may cause the section of core being displayed to 
change without rerequesting a DUMP by the use of this and the follow- 
ing command. PACE changes the display to DUMP the section of core 
iammediately following the one currently being displayed. The length 
of the section displayed remains the same. If the DEBUG ‘system is 
Gueecently inthe HOLD mode, the display will not be altered but all 
PAGE commands will be stored for cumulative operation when the 
etsplayis FREEd.,. 
6. BACK Command 
This command functions as the inverse of the PAGE command, 


and causes the display to present the immediately preceeding portion of 








core memory. It also operates under the influence of the HOLD and 
FREE commands. 
ive bis f Conimeand 
The LIST command allows the user to display selected individ. 
ual XDS 9300 core memory locations, which need not be contiguous. 
The display is presented dynamically with one location per line, giving 
Emessymabolic name ii any, the octal address of the location and the 
representation of its contents in octal, decimal, floating point and BCD. 
8. UNLIST Command 
ive UNLIST command selectively removes an individual 
location from the set of locations being LISTed, or may be used to 
melete the entire LIST display. 
9. GATED Command 
This command presents a display of the status words for the 
Papnics and text interface between the other AGT -10 amd the ADs 9300. 
Included are a description of the mode indicated by the status word, the 
Peeepmics or text block referenced and an octal dump oi a portion of the 
Peck if Sraphics, or an octal and BCD dump of the entire block if text. 
The display is dynamic in nature, similar to the DUMP and LIST 
commands. 
10. Symbol Definition Command 
This command allows the user to equate values with various 
symbols for later use as command operands. It is primarily intended 


as a typing and memory convenience for the user, in that once d name 
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is associated with a particular address or value the user may type 
that name rather than the octal, decimal or BCD representation of the 
address or value. 
11. Value Inquiry Command 
The value inquiry command allows the user to determine the 
current value of a symbol, if defined, or to evaluate a simple arithmetic 
expression of operands of varying type. When examining a dump it is 
particularly useful for performing base éight address relocation. 
12. DELETE Command 
The DELETE command removes a single symbol from the 
symbol table, or the user's option, will clear the entire table. 
13. AMRMX Command 
This command causes the DEBUG system to immediately 
Meixrn control to the AMRMX monitor system. Jf DEBUG is sub- 
seamentiy reentered eet beingureloaded. it will) rec ofrecer: ora 


Ma@eestatus at which the monitor return occured. 


ieeeNTE RACTIVE LEVEL 
At the SHO ACIRE level, the user may cause modification of the 
PeaeelitOn-timie Copy of his program or interrupt the course of program 
execution by use of several commands: 
Do 2 Mee onaimna nd 
The FILL command allows the user to replace the contents of 


One to one hundred sixty contiguous celjs of XDS 9300 core m®mory 








with a valuemspecifiedsin octal, decmualeaiicarine poimtogrs © Oss line 
operation of FILL is immediate amcenon= ec curpine wand typical yucca 
for altering the values of lupher le Veilansuape program varia les. 
2. BABY Command 
This command allows the user to commence a babysitting 
Speration on a given core memory location imthe XD5S99300. IWecauses 
the generation of a LIST of the given location, and initiates a continuing 
check on the value of the contents of the location. When the value of 
mreslocation's contents pass om@tside the range speciiied by the user, 
Bgewst> 9300 is halted and the appropriate LIST entry in the display is 
flagged. 
oo, bres Command 
This command places a breakpoint trap ait the specified location. 
When the location is subsequently executed by the XDS 9300 program, 
jeswexecution is suspended and a message appears on the AGT-10 
Saepiay screen providing the location of the trap and the contents of 
various ADS 9300 registers. 
4. UNTRAP Command 
Diaicweoimnand removes dapmevlous i soleced preakpoim trap 
irom the specified location. 
>. Aa Gonmnond 
. This command causes execution of the user's XDS 9300 
program to be suspended as execution is commenced. It must be 
Mssucd prior to the exccution phase of the user's program, Siahecs 


during compilation or loading. 








6. STOR WGonrnand 
STOP causes the XDS 9300 program execution to be suspended. 
7. GO Command 
The GO command restarts XDS 9300 execution of the tiSie rs 
program at the location from which it was suspended, or at another 
Meer Sspecifzaed location. This command isaised to recover fram a 
freByY, TRAP, ATEX, or STOP command. 
8. SLOW Command 
The function of this command is to allow the user to specify 
a slower rate of execution for a program on the attached computer. 
Execution speed may be decreased by any ratio in the range of one 
tenth to one hundred-thousandth the normal execution speed. A con- 
tinuous display of the contents of the location, A, B, and index 
registers of the XDS 9300 is automatically provided on the AGT-10 
graphics display while in the SLOW mode. 
oe, HAS TF Command 
Thisctcommiand restores (ie ee 5r9300 to tliliexcoution speed 


and removes the dynamic display of the XDS 9300 Eecicrers, 


See AUTOMATIC SYMBOL LEVEL 

At the highest level of interaction with the user's program, it is 
necessary that the program be compiled and executed with the fore- 
knowledge that debugging with the use of DEBUG will be expected. 


However, with this foreknowledge, the programmer may have the 
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obvious advantage of letting DEBUG predefine the symbols that occur 
within his higher-level language program, thus facilitating his refer- 
ence to them while debugging. This feature is enabled within DEBUG 
with the use of the SYMBOLS command: 
1. SYMBOLS Command 

The SYMBOLS command will transfer information from the 
XDS 9300 program concerning the names of program variables and 
entry points into the DEBUG system. It may only be executed once 
execution of the user's program on the XDS 9300 has commenced, and 
mecqurres that a NAMETLIST statement be included in each FORTRAN 
program for which the symbols are to be defined. It is convenient to 
use the ATEX command to hold execution so that SYMBOLS may be 


executed. 
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VI; IND BRN eS vom So tie TUR 


Sufficient information appears elsewhere in this paper to assist 
the user in operating the DEBUG system. The material in this section 
meeintended primarily for those eee with internal structure as 
might be the case if the system were extended or modified for use at 


another installation. 


A. INTERRUPT HANDLING CONSIDERATIONS 

PP Priddy COlsigeration Wilthie prograimmino OF thers yoreraus 
mmemextensive usie of the interrupt structure of the AGT-.10. All input.. 
Smeeut On the teletypewriter, the channel to the XDS 9300, and the 
graphics display subsystem operates on the basis of hardware interrupts. 
It is important to note that as the graphics display is continually in use, 
mpmcevenerates an interrupt for each word of data to be fetched for dis— 
mliay, interrupts may occur at any point in the programming. Delays 
in processing these interrupts may cause unusual display images, or 
at best an extremely annoying display flicker. A secondary considera - 
iMmogmenrere is that a display buffer may frequently be in the process of 
being referenced for display at the same time as it is being filled. 
This requires that program code must maintaina legal display 
meprcCoctitatron in tae display buiferj i, e. it may not be used for 
Eeraponrary Storage, at mist be filled in a strictly torward manner, 


and a valid terminator must always appear following the buficr cor: 
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B. COMMAND PROCESSING 
The major portion of the DWBUGiey st mercrccy Oled ton processing 
Ofuser commands. Indeed, the order of program segment execution 
harman the system is dependent almost entirely upon the operator. 
Command processing may be thought of as a series of subroutines 
ppecitically initiated either immediately or under controljof the main 
commutator. The interface between these subroutines and the user is 
mre command decoder. 
Peeeeerminand Decoder 

The command decoder is entered froma gate set in the main 
commutator upon receipt of the carriage return character from the 
fetetypewriter. Thus, command decoding and execution do not occur 
at interrupt time, but rather at the next circuit around the commutator 
loop. 

The decoder is a context dependent scanner based upon a 
Mmeaeined table of delimiters. The occurrence of any delimiter 
ee notes the end of an argument, which includes all characters typed 
since the last delimiter. The defined delimiters include the following 
characters: 

Gan re OCs ena hin) = on) eee ete 

Ortitese, the Jast three characters are pseudo delimiters, 
and denote the end of pseudo arguments. A pseudo argument is one 
that is not complete in itself, such as a subfield of an arithmetic 


Pepto scton. sat pseudo arpumlents Deiween normal delimiters ars 








collected, combined in the appropimate mates, and stored as a single 
apuInent, For each argument information is stored as to the value, 
Eocyeleneth and trailing delimiter. Up to six arguments may be proc- 
essed, Octal and decimal arguments are converted to the appropriate 
numerical values. Alphameric arguments are checked against the 
symbol table, and replaced by the value attached to the symbol if 
defined. Otherwise, such arguments are stored ina BCD representation 
with four characters per word, right justified with a leading BCD zero. 
Mime fOrmat corresponds directly to the internal XDS 9300 representation 
and its shorter 24 bit word length. 

After the command has been scanned, and if no errors have 
‘been detected, the command is interpreted and executed. If the first 
delimiter is an equals sign it is presumed to be a symbol definition or 
value inquiry command and is processed AG contami A first delimiver 
of a left parenthesis or carriage return is the only other acceptable 
circumistance and implies that the first argument is a command name, 
This command name is looked up ina table of defined commands, and 
the corresponding subroutine call to a command processor is executed. 

2. Command Processors 

EKach of the command processors is an independent subroutine. 
These subroutines either perform the requested action or set appro- 
priate gates in the commutator for later execution as in the case of 
DUMP, LIST, BABY, TRAP and similar commands of a recurring or 


Bominuous patwre, In either case, ali nccessary iniornietions 








extracted from the command decodermareument table so that iui hes 
input may be received. This information is stored in specific variables, 
such as the DUMP starting address and length, or in tables, as is the 
case with LIST to record the locations being displayed. The LIST table 
provides entries for minimum and maximum allowable values of the 
associated location and thus functions as the reference storage for BABY. 

A considerable portion of the command processors is devoted 
fomiue conversion of data from one format to another, which is required 
due to the differences between the XDS 9300, AGT-10, teletypewriter 
and graphics display subsystem representations of symbolic and 
numerical values. This is provided in part by a set of conversion 
subroutines in the input-output section for those requirements that are 
@ia peneral and repetitive nature. Due to the frequency with which 
omic program segments are executed, such portions have been coded 
for maximum speed of execution with less regard to the Area eietnt of 


memory space required for the coding. 


fee y MBOL TABLE ORGANIZATION 

The need for an ability to define frequently used symbols is obvious 
for an rower e debugging system suchas DEBUG. Towever, due to 
Biemmeture Of the System the references to the table are fairly infrequent, 
TmemaeeecesS tlime 1S MOt 2 major concern. For greatest user convenience, 
tie table must be accessible using either the symbol or its value as the 


hey 10 retrieve the other entity. This enables the system to readily 








attach all defined symbols to portions of XDS 9300 core memory appear- 
ing on the display in commands suchas LIST. Furthermore, it is 
desirable to arrange the table so that it is searched ina well-defined 
order, thus facilitating the use of qualified symbol names. If the user 
refers to a qualified symbol without the qualifier, he must be able to 
Paedict which reference will be extracted. Wwe to these considerations, 
the symbol table was implemented as a simple lst, and is searched 
bottom-up by either of two subroutines for referencing the symbol or 

its value. The symbol table is designed to overlay the AMRMX monitor 
if it extends beyond its reserved area, and thus has room for at least 


meOO symbols. 


D. XDS 9300 COMMUNICATION 

Communication between DEBUG and the XDS 9300 occurs on two 
levels, which correspond essentially to the two lowest levels of DEBUG 
maveraction, 

1. Non-Interactive Communication 

In this mode DEBUG simply observes the contents of selected 

portions of XDS 9300 core memory. This is accomplished with a sub- 
routine to drive the Adage Interface Multiplexer and Memory Interface 
which attaches to the XDS Memory Interface Channel. The subroutine 
can transfer any length of block from any location in either machine 
Po the other. Inuse, the data from the XDS 9300 is transferred to 
reserved areas in DEBUG depending upon the command requesting th 


transiter. 








2. Interactive Commiumicalrom 
For commands requiring control of XDS 9300 program execution, 

it is necessary to enable the interrupt system between the computers 
maith the AGT control card under the ~WS Real Time Monitor, DEBUG 
then inserts a short interrupt processing and control routine in the AGT 
tape buffer area in upper XDS 9300 core memory. Control is maintained 
mde xercised with the use of interrupts in both directrons initiated by 
ieBUG and the coding it has inserted in the XDS 9300 and by appropriate 
miterations in the contents of the XDS 9300 core memory contents using 


Bmeesubroutine previously described. 


ee) 
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Vie USINGAiE DEBUGGING .j Ys Tait 


Utilization of any debugging system is highly dependent upon the 
nature of the problems which the user is attempting to trace. DEBUG 
is intended particularly as an aid for debugging execution-time errors 
in FORTRAN and assembly language programs onthe XDS 9300. Al- 
though it might certainly be useful in detecting, locating and eliminating 
bugs under other circumstances on this hardware configuration, this 
paper will be restricted to describing the debugging process for the 
atrorementioned intended usage. 

In the case of a program which is known to contain errors, DEBUG 
meuld normally be initiated prior to the execution time phase of the 
Meer's program. This allows the user to hold execution by the use of 
the ATEX command, which provides a convenient time to prepare for 
the debugging to follow. The user should have previously considered 
whether or not he wishes to use the automatic symbol definition feature, 
and if so he would normally request the SYMBOLS command at this 
Gime, Otherwise, using the information from the compiler and assembler 
reference tables and loader memory allocation maps printed by the XD5 
"eo monitor system prior to execution, the user might define pertinent 
symbols with the symbol definition command. A convenient mcthod of 
doing this ls tom Got idetimertm@e: DrOolham onlpin of the Entire usc weoecimdent, 


then define the individual program subroutine names relative to the 








segment according to the relative segment map, and finally define 
specific program variable names relative to their respective sub- 
routine names. Such relative addressing is easily performed by the 
use of the simple octal arithmetic addition expression in operands such 
aoe S=PROG1+537. 

After providing for the definition of such symbols as may be con- 
venient, the user would frequently set a decreased rate of execution, 
LIST or DUMF appropriate variables or program portions and allow 
execution to proceed. The reduced execution rate, obtained by the use 
of the SLOW command, allows a user to more readily observe the 
progress of his program, as well as providing continuously updated 
@epres of the XDS 9300 program referenceable machine registers on 
@aewecl-10 display screen. One of these, the location register, pro- 
vides the user with the location of the current instruction being executed, 
thus facilitating the attempt to follow program flow. 

im the user becomes aware that his program is destroying portions 
of code or data he might examine a DUMF of selected portions and 
reexecute the program with babysitting enabled on Suspected index 
variables. This provides an easy means Crcetectiimesamuray Telercnecs 
beyond the bounds of the array if the babysitting bounds are appropriately 
chosen. Errors in program logic may frequently be detected with 
feeicious use of the LIST, BABY, and TRAP commands. TRAP is 
often used as a substitute for the numerous WRITE or PRINT state 


PycMEssInSet led 1a procrain decks by nevice programmers atte: ume 
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to trace program flow. By TRAFPing and using a LIST or DUMP of 
appropriate variables when the trap occurs, similar information may 
be obtained entirely at the symbolic level ona faster, interactive basis, 

During the course of debugging user programs, it is often found 
Meat errors in programming may be temporarily patched for testing 
purposes online without the need to recompile the program. For 
Baotance, One oi the frequent ageuiliis of keypunch errors is thata 
program may refer to the wrong variable at some point in the program. 
If the user is familiar with the XDS 9300 machine language, he might 
elter the reference to use the correct variable using FILL. Otherwise, 
Mieswser may alter the value of the intended variable as necessary during 
' the course of execution usiie. } Leto do the allerineg andisinoen be 
memelert him to the need for an alter. 

DEBUG also provides 2 convenient means for testing a working 
program with varying data or parameter values to optimize some 
aspect of program performance. A TRAP command might be inserted 
wees point near the termination of the program. Each time the trap 
@eeurs, the user may alter the desired ee aOR valwes Using the 
FILL command, and restart the program near the beginning with the 
@e command. It should be noted that it is possible for the user to 
define FORTRAN statement numbers (including at least one non-numeric 
character, suchas 10S) from the information printed at compilation 


and loading in a similar manner to defining program variable names. 








This enables the ease with which the user may alter the flow of 


execution within his program. 
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VIIl.. OBSERVA TI@NS2 web aCONCLUSIONS 


During the course of implementation and experimentation with the 
DEBUG system, considerable eCxperience was obtained in debugging 
programs on the XDS 9300 in an online environment. Although a portion 
of this experience was intentional, many of the sessions were initiated 
from the author's observation of other student's efforts to debug pro- 
grams in an offline mode with the opportunity to assist by demonstrating 
an easier means of accomplishing the goal. Most of these sessions 
were quite productive and enthusiastically received by the users. In 
some cases an aura of mystique seemed to surround the interactive 
Mummcisae Lochnva6 aimome tie t:OSt Inox porte nc ed sem cgr ei tons meen 
DEBUG system appears at the present stage of development not to be 
fadtca fOr use by novice computer users, Most advanced graduate 
students in computer ee subject areas readily adapted to the 
system and appreciated its functions. 

Py noeticeable decrease in debugging time was observed in the online 
debugging mode as compared to more conventional BEechniqucs, however 
this is achieved at the expense of increased machine time per run. It 
has been observed that the overall reduction in number of attempts and 
repeated compilations normally more than compensate for the longer 


individual runtimes. This is somewhat dependent upon the suitability 


~ TANT Fe 
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Perhaps even greater economies would be evident in a time-sharing 
environment. Asa result of the sustained user effort to debug a given 
program in fewer more lengthy sessions, his understanding and con- 
eenvration on his particular progress ceimea to increase sracrepy 
eliminating a certain amount of time otherwise required to refamiliarize 
himself with his program after each recompilation in the conventional 
offline batch method. 

Several of the features in the current version of DEBUG were 
implemented as a result of user experience with the system. These 
have facilitated the use of the system by users having a familiarity with 
Higher level languages and relatively little experience with either the 
XDS 9300 or assembly languages. As originally conceived, the system 
was more dependent upon user knowledge of console techniques and 
internal machine organization of code and data. Further improvements 
for usage by persons familiar with only higher level language coding 
and debugging techniques have been considered, anda few of these will 


wemmgiven brief consideration here. 


Po GGHoTIONS FOR FURTHER DEVELOPMENT 
ae AGT-10 used in the project possesses a graphical as wellas 
a textual capability. Vector generation hardware is built in, but to 
date unused by DEBUG. The author has been unable to find any documen- 
tation in the profession showing utilization of such a configuration in the 


ebugping process. In an attemipt to utilize these capabilities of ile 
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equipment as a visual aid to debugging, preliminary investigations were 
made as to the feasibility of two graphical debugging features. 

The first graphical feature considered was an automatic, dynamic 
program flow diagram. Using source language statement numbers or 
other user supplied labels as block designators, the graphical display 
would consist of a series of straight line segments connecting block 
Sesigonators in the sequence of Execution of the corresponding state- 
ments or program code sections. Such information could be readily 
extracted from the program during execution and supplhed with minimal 
miodification to the vector generator for display, although necessitating 
@eneduced rate of execution of the subject program. Hopefully, suche 
display might provide indications of errors in logic, unexpected loops 
m@eetie like if SUiiiciently detailed information could be "SNtracted amd 
displayed ina manner directly relating to the user's source program. 

Most of the debugging features implemented or considered have been 
feeiditly detailed level. Some users have expressed a desire fier the 
ability to view the operation of their program from a more global 
position. This suggestion brought about the consideration of another 
meapnical feature. As DEBUG has ready access to the information in 
the XDS 9300 concerning subprogram linkage, including subroutine 
names even when not in the automatic symbol mode, some provision 
for graphically displaying subroutine calls was contemplated. This 
might take the form of a dynamic histogram showing relative amounts 


oi central processor time spent in cach subroutine, or of the Meqicicy 
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of calls to each. By supplying a dummy program segment with multiple 
entry points and inserting corresponding calls in his program, the user 
might obtain a visual indication of flow within each individual program 


Se). 


me CONCLUDING REMARKS 

The Interactive Graphical Debugging System described here has 
been fully implemented and tested at the time of submission of this 
thesis. It is available and operational as a tool to aid in the debugging 
of programs on the system under consideration. Although no known 
bugs within DEBUG exist, the user must adhere to the command 
language as described in this paper, as some undefined combinations 
@eeaput May cause pmopram failure. No attempt has been made to 
make the system foolproof, although the more obvious operator errors 


produce error messages from the system. 


Ad 


APPENDIX A 
NON-_INTER FERENCE COMMANDS 


A description of each of the commands available in the non- 
interference mode of operation follows. The commands are presented 
in the format given in Section IV.B, with a brief description of the 
operands applicable to the command, restrictions that may exist, and 
examples where helpful. In the descriptions, all constants are as 
described in Section 1V.A.4, thus numeric constants not containing a 


decimal point represent octal values. 


GOMMAND DESCRIPTION 





COMMAND OPERANDS 
DUMP (fret, last 
WHERE 
first = first location FONG GUmMiIpeCd: Ocetal. Cecgimed by syiloo! 


or expression in the range (20000, 77777) 

last = last location t® be dumped; octal, decimal, symbol 
or expression in the range (20000,77777); default 
value = firstt237 


fiGse < last< first+237 
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FUNCTION 

This cormmand initiates a dynamic octalang BC memory dumaoson 
fue.selected portion of XDovgsUCrceresmenionm son wie or Oeics plan. 
As many as 240 (octal) locations may be displayed at one time. The 
first and last values specified by the user are rounded down and up, 
respectively, to the nearest multiple of eight prior to displaying the 
region. A DUMF currently being displayed will be replaced by the new 


region when this command is executed. 


BeCAMPLE 
Assuming the symbol ORG is defined as 24053, the following com- 
mand will dump locations 24050 through 24107: 


DUMP(ORG, ORG+30) 


COMMAND DESCRIPTION 


COMMAND OPERANDS 


Pt tig: Pin aS ea RE RI Ol IIT 5! SE ay AP RP IE EL PCD RR 


UNDUMP 





FUNCTION 

The function of this command is to terminate the current DUMP 
display, thus providing more area on the AGT-10 display screen for 
other command displays. No operands are necessary. The command 


is ignored if no DUMP is in operation. 








COMMAND DESCRIPTION 


OPERANDS 


This command disables the dynamic updating of the current DUMP 





FUNCTION 


display. No operands are necessary. The command is ignored ifa 


DUMP is not currently being displayed. 


COMMAND DESCRIPTION 





ee a 


COMMAND GPR. 





eR ee 


FUNCTION 

ime function of this command is to meverse the operation of a 
preceding HOLD command, thus restoring the dynamic updating of the 
current DUMF display. No operands are necessary. The command is 


ignored if a HOLD or a DUMP has not been executed. 


COMMAND DESCRIPTION 











COMMAND GPA DS 











FUNC Tie 


This command causes the current DUMP command to display the 
region of XDS 9300 core memory immediately following the one currently 
being displayed. The length of the region remains unchanged. If currently 
in the HOLD mode, the display will not be altered until the display is 
FREEd, at which time all PAGE commands will have a cumulative effect. 
PAGE commands will be ignored if no DUMP is in operation or if the 
eurrent region being displayed is at the upper core limit of the XDS 9300. 


No operands are necessary. 


COMMAND DESCRIPTION 





COMMAND OPERANDS 


Sa gr ge ag a ea a, oo 8 Tn ee te Ont hen a, 





FUNCTION 

Minis command functions ina similar manner as the PAGE command, 
@owcing the preceding section of core memory to be displayed. If in the 
iets mode, all BACK commands are stored for cumulative operation 
Saver subsequently FREEd, If the current display is at the lower core 
limit of the XDS 9300, or if no DUMP is in operation this command is 


ignored. No operands are necessary. 








COMMAND DESCRIPTION 


COMMAND OPERANDS 


Tels ae Bese al, Meer) 





WHERE 


for St = first location to be displayed; octal, decimal, symbol 
or expression in the range (20000, 77777) 
last = last location to be displayed; octal, decimal, symbol 
or expression in the range (20000, 77777); default 
value = first 
first< last< fir sSico 0. 
FUNCTION 


This command initiates a LIST operation if none is in progress and 
adds the location or locations specified to the display. All locations are 
displayed one per line, giving the symbolic name if any, octal address 
of the location, and the representation of its contents in octal, decimal, 
floating-point and BCD. A maximum of forty locations may be simulta- 


neously displayed. 


EXAMPLE 
Assuming the symbol X has been previously defined, the following 
command will display the location and its contents: 


. 


‘LIS T(X) 


ay 








COMMAND DESCRIPTION 


COMMAND OPERANDS 
UNLIST [(loc)] 
Waa 
FOE... = location Of an itemimcebe removed 1s Ont pice ero edic olag, 


Gctal, Gecimal, symbol Orvexpression im the cance 
(Z0000, 77777)s default remowes the entire LIS Lf display 
mUNCTION 
The function of this command is to remove a selected individual 
location from the currently active iis Tf command.) Optional wi 16 
Eeeranedis supplied’ the entire LIST display is removed. An error 
message is gencrated if it is attempted to remove a location that is not 
eucrently inthe LIST display. UNLIST is ignored if no LIST is in 


operation. 


EXAMPLE 
The following command will delete the location Y+2 from the current 
LIST display: 


CENT SIS) 


COMMAND DESCRIPTION 








COMMAND OPERANDS 











FUNCTION 


This command provides a dynamic display of the software graphics 
and text interface between the XDS 9300 and the other AGT-10. No 
®perands are necessary. woubsequent execution of any other command 


using the graphics display subsystem terminates the GATED command. 


COMMAND DESCRIPTION 


© SIME IS IE, COMMAND OPERAND 





name = é value | 


a 


W HERE 
Sere = symbol which is to he defined 
value = value to be attached to the symbol; octal, decimal, 
symbol or expression in the range representable in 
the 24-bit word length of the XDS 9300 





FUNCTION 


The symbol definition command attaches the specified value to the 
Sxanbol being defined. The symbol is entered into the symbol table and 


takes precedence over any previous definitions of the same symbol. 


a 


EXAMPLE 


The following command defines the symbol MAIN as having the value 
of 24157, assuming ORG has been previously defined as 24053: 


MAIN=ORG+104 








COMMAND DESCRIPTION 


OF Beco) COMMAND 





WHERE 


item operand to be evaluated; octal, decimal, symbol or 
expression in the range representable in the 24 bit 
word leupth of the XS 9300 


FUNCTION 


The value inquiry command enables the user to determine the current 
value of a symbol, or to evaluate a simple arithmetic expression. A 
value inquiry command issued for an undefined symbol generates an 


error message. 


COMMAND DESCRIPTION 






SE DP AL TP REL EE PT ET TRAD 


OPERANDS 


DELETE [(name)] 








name = symbol to be removed from the symbol table; 
default clears the entire symbol table 


Bye 








FUNCTION 
The function of this command is to allow individual symbols to be 
deleted from the symbol table, or optionally to clear the entire table. 


An attempt to remove an undefined symbol generates an error message. 


Pea IMP Lk 


The following command would remove all symbols from the symbol 
Eeple. 


peaks 


COMMAND DESCRIPTION 








COMMAND OPERANDS 
i { 
| AMRMX | 
FUNCTION 


ihe function of this command is to return control immediately to 
the AMRMX monitor system on the AGT-10. DEBUG is not initialized, 
so that subsequent reentry will allow execution to proceed from the point 


at which it exited. 








APPENDIX B 
INTERACTIVE COMMANDS 


A description of each of the commands available in the interactive 
and automatic symbol modes of operation follows. These commands are 
presented in the format given in Section 1V.B, with descriptions, 
restrictions and examples where applicable. All constants areas 


described in Section IV. A, 4. 


COMMAND DESCRIPTION 






COMMAND OPrPlk DS 













(value, first[, last]) 


anegument to be placed in the locations specilied; octal 
decimal, floating-point, character string, symbol or 
expression in the range representable in the XDS 9300 
24 bit word length 


ins ¢ = its PVocatiom tonbee | edt O@ctalan decimal, ‘symbol 
OF expression im the range (70000. 7777/7) 
last = last location to be filled; octal, decimal, symbol or 


expression in the range (20000, 77777); default value 
= first 


NSO last < firstt+237 








FUNCTION 

The functionjof this comineand 1s to store the speéeitied valuc amione 
to two hundred forty (octal) locations of XDS 9300 core memory. If 
the third operand is omitted, only one location will be filled. 
mpOA NIP LE 

Ebie follow ine scomimane will Stone {mes Cl tciatactCrict cm .ie Dp) 
in twenty-four contiguous locations beginning at ORG: 


Gunn EC DIORIG—ORIG 224. ) 


COMMAND DESCRIPTION 











COMMAND OPERANDS 





BABY Qoc[, lower, higher]) 


WHERE 











loc - location to be babysat; octal, decimal mcyimvel oz 
expression inthe range (20000, 77777) 


lower = minimum allowable value in loc; octal, decimal, 
HOdtintg=pOmt. Character string, .sylapol or explesic10 
in the range representable in the XDS 9300 24 bit word 
lengpth, default = present value in Loc 

higher = maximum allowable vaiue in loc; octal, decimal, 
floating=point, Gharacter string, Symbol or expression 
in the range representable in the XDS 9300 24 bit word 
bength; default ="eresent value im toc 

FUNCTION 
This cominand initiates a LIST of the specified location if one is 


not currently in operation, and sets the limits for a babysitting operation 


Cn 
Wn 








omthat location, ji the aruthimetie va lwesot the location cscontentsmea a 
beyond the specified range, execution of the XDS 9300 is suspended and 


the display is flagged for user attention. 


EXAMPLE 
The following command will initiate a LIST of location 45031, and 
Mmiterrupt execution if its contents change from the current value: 


Beeb y (450 a) 


COMMAND DESCRIPTION 














COMMAND OPERANDS 
Ae RACE (loc) i 
WHERE 
rec = loeatiom im which a tap 1s tO be cee, Octal mace cima 


symbol or expression in the range (00000, 77777) 


FUNCTION 

This command places a breakpoint trap in the specified Refesinierel: 
itepre AIS 9300 subsequently executes the ISeationpelecmeseCUlIOM 1s 
suspended and a message alerts the user on the AGT-10 display screen. 
When program execution on the XDS 9300 is restarted the first instruc- 


t10on to be executed will be that originally in the specified location. 








EXAMPLE 


Assuming MAIN is defined as 25000, the following command places 


a trap at location 25536: 


TRAP(MAIN+5 36) 


COMMAND DESCRIPTION 


COMMAND OPERANDS 
UNTRAP (loc) 
| WHERE = 
SEN eee a NEE ee OR eT 
loc ~ location from which a trap is to be removed; octal, | 


decimal, symbol or expression in the range (00000, Ss, 


Ca ae ae ee ee fe ee eed 











ee 





FUNCTION 


The function of this command is to remove a previously placed 
trap from the specified location. An error message is generated if ne 


trap is in operation at the specified location. 


man MIP LE 


The following command will remove a trap from location 16901.: 


UNTRAP(16901. ) 


ZOMMAND DESCRIPTION 









OPERANDS | 


me ORR mr CN A AY A SE 


COMMAND 


SF ED, P| RT ED PE RP ce I Si Wa Ts GR EF mR 


Pex 
— SB LY PPPOE. LI OPT PCIE TET SAPONINS SE Mt a ad 





FUNCTION 
This commendssuspends execution olsthe user's XD> 9300 program 
when it enters the execution phase. ATEX must be executed prior to 


eseCution-time. SNOjoperandcsate MCceScary. 


ZOMMAND DESCRIPTION 


COMMAND OF BRANDS 


DOr 


FUNCTION 


The function of this command is to suspend XDS 9300 program 


execution. No operands are necessary. 


COMMAND DESCRIPTION 





Ore yt 


COMMAND OPERANDS 


[(start) | 





WHERE 








Start = location at which execution is to be restarted; octal, 


decimal, symbol or expression in the range (00000, 77777} 
default = next sequential location 


This command enables the user to restart execution of a program on 


FUNCTION 


{rar 


the XDS 9300 following its suspension due to a command such is B.ASYT, 


58 








TRAP, ATEX or SIOP. am operands specinedthe command 
functions as a transfer, otherwise execution is resumed from the 
place at which it was halted. ViiGO ictcmeccuted when the “Bs 9s00sis 


mot halted an error message 1s generated. 


EXAMPLE 


The following command will restart the XDS 9300 with a branch to 


mae 1ocation defined by the symbol INIT: 


COUNT) 


COMMAND DESCRIPTION 


| COMMAND | OPERANDS 


Sra a a Om ae er er et EE Ea SE eS 


Sn) VV (ratio) 


Wa RIS 








ratio = value by which @<ccution rate of > 9300 is to be 
dinmi@ied-@OGta | deGimeai G3, syim100l baseme ranges 10s. 


100000. ) | 

FUN CTION 
This command causes the execution rate of the XDS 9300 program 
weepe divided by the specified ratio. A dynamic display of the contents 
of the XDS 9300 location, A, Band index registers is presented while 


mo the SLOW mode. 


ay, 








XA MPa 
The feollowing command causes XDS 9300 program execution to 
proceed at one-hundredth the normal rate: 


SLOW (100 2) 


COMMAND DESCRIPTION 






OPER AN Ds 





FUNCTION 


This command functions to restore the normal rate of XDS 9300 
“program execution. No operands are necessary. An error message 


rs generated if DEBUC is not in the SLOW mode. 


COMMAND DESCRIPTION 






OP Eis 






COMMAND 


AIRTIME flee EOI A 









SYMBOLS 






f 


FUNCTION 


This command causes automatic definition in the DEBUG symbol 
table of all defined entry points and NAMELIST variable names in the 
XDS 9300 program. It must be executed only after the execution phase 


of the user's program has commenced. 
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